home *** CD-ROM | disk | FTP | other *** search
- *** MultiClock ***
- Version 1.0
- -----------------------------------------------------------------
- © Hugh Leslie 1992
-
- This program is FreeWare and may be freely distributed as long as
- no money is charged for it apart from a reasonable amount for
- copying and the cost of the media. Please keep this distribution
- together.
- If you like this program and use it I would very much like to hear
- from you.
-
- I can be reached at:
-
- 9 Melville Road
- West Brunswick, 3068
- Melbourne
- Australia.
-
- or
-
- FidoNet - Amiga Central BBS, OZ. (3:633/353)
-
-
-
- ** N.B. This program requires v2.0 or greater Operating System **
-
-
- MultiClock is a simple titlebar clock commodity with lots of
- flexibility and many extra features such as:
-
- * A very flexible format for the clock which allows you to show
- the time and date in virtually any way you like. Also will
- display memory, the type of processor you are running, and
- all this in as many colours as you want.
-
- * The ability to speak the time using digitised speech or the
- inbuilt narrator device.
-
- * Chimes using inbuilt or digitised sounds on the hour, half
- hour or quarter hour.
-
- * An alarm which again allows you to use inbuilt or digitised
- sounds and also launch a batch or Arexx file on an Alarm.
-
- -----------------------------------------------------------------
- -Running the program.-
- -----------------------------------------------------------------
-
- The program is run from Workbench by clicking on the icon or
- simply by putting it in your WorkbenchStartup drawer. It can be
- run from the CLI by specifying tooltypes as arguments.
-
- ToolTypes: CX_POPUP=YES Pops control window up
- immediately.
- Defaults to NO.
-
- CX_PRIORITY=n Where n is priority to run at.
- Default is 0.
-
- CX_POPKEY=string ie alt f10 - Hotkey to pop
- control window up with.
- Default = control f10
-
- HIDE_CLOCKKEY=string Hotkey to toggle clock on
- & off screen - useful if
- changing screen prefs so
- that you dont have to
- close the program down.
-
- SAY_TIMEKEY=string Hotkey to say time in
- current mode.
-
- DONOTWAIT Standard commodity command
- to tell WorkBench not to
- wait for the program to
- finish.
-
- CLOCKCONFIG=string This is where you may
- define what you want your
- clock to look like. See below.
-
-
- -----------------------------------------------------------------
- -Configuring the clock.-
- -----------------------------------------------------------------
- On starting the clock you will see a default time and date in the
- title bar of your workbench screen. This can easily be changed on
- the fly by activating the program window either through its HotKey
- (which defaults to control f10) or via the commodities exchange
- program.
-
- When this window is activated you will see a large text gadget
- with a clear button at the end. Any text you type in this gadget
- will be displayed as is in the title bar, however the clock
- understands a number of codes which are inserted by putting them
- between <>. These
- codes are as follows.
-
-
- <MC> Inserts chip memory in K
- <MF> Inserts fast memory in K
- <MT> Inserts total memory in K
-
- <Hn> Inserts Hour - n is either: 1 = 12 hour clock
- or 2 = 24 hour clock.
- <NM> Inserts Minutes.
- <SS> Inserts Seconds.
-
- <Fc> Inserts flashing character where c is any single
- character.
- Flashes at 1 second interval.
-
- <PM> Inserts 'AM' or 'PM' depending on time of day.
- Lower case will give lower case letters and
- uppercase upper.
-
- <Dn> Inserts Day of the week.
- n is either: 1 = 3 character day ie "Mon"
- or 2 = Full name ie "Monday".
-
- <DT> Inserts a 2 digit date (ie day of month).
- <TH> Inserts 'st', 'nd', 'rd', or 'th' depending on the
- date. ie if the date is 12 then <TH> will give 'th'
- but if 2 it will give 'nd'.
-
- <On> Inserts Month. n is one of:
- 1 = numerical date with leading zero suppressed.
- 2 = 3 character month ie "Jun"
- 3 = Full name ie "June".
-
- <YY> Inserts 2 digit year.
-
- <Cn> or <Cnn> will change the rendering colour to colour n
- or nn.
-
- <PR> Inserts processor as in '680x0'
-
-
- The default Config is -
-
- "<D2> <DT><TH> <O3> 19<YY> <H1><C2><F:><C0><NM> <pm>"
-
- Tonight this gives - Monday 8th June 1992 11:32 pm
- ^
- |
- note ':' is
- flashing a different colour.
-
- <DT>/<O1>/<YY> would give 8/6/92
-
- Any text not between <> will be printed as is.
-
- -----------------------------------------------------------------
- -Chime Window-
- -----------------------------------------------------------------
- On the main window is a button called Chime. This button will
- take you to the Chime set up window.
-
- This panel allows you to set up a "chime" to occur at hourly,
- 1/2 hourly, or 1/4 hourly intervals. The chime can be one of:
-
- Simple "Beep".
- Three Beeps starting 3 seconds before the actual time.
- A sampled sound.
- The anouncement of the time.
-
- All of these can be selected by simply clicking on the cycle
- gadgets to show the one you want.
-
- When you select a sampled sound you can then select the "Load
- Sample" button and through the file requestor select a sample to
- load.
-
- The file name is shown in the text box without its pathname,
- however the program will remember this pathname when you next
- start it. If you move the program without reselecting the path
- then the program may not be able to find your sample. Just
- reselect it if this happens.
-
- You can test any of these sounds by clicking on the "Test Sound"
- button.
-
- Selecting OK will put these changes into use otherwise selecting
- cancel will revert to the previous options.
-
- NB. TO TURN ON THE CHIME YOU MUST SELECT THE "CHIME ON" GADGET IN
- THE MAIN WINDOW.
-
- ------------------------------------------------------------------
- -Alarm Window-
- ------------------------------------------------------------------
- Selecting the Alarm button will bring up the Alarm window.
-
- This window is divided into three main areas:
-
- 1. The time select area has two sliders and a time display
- gadget. This allows you to select a time for the alarm to sound
- which is accurate to the second.
-
- 2. The sound area - this allows you to select the type of sound
- you would like the program to produce when the Alarm time is
- reached. The selection process is exectly the same as for the
- chime window.
-
- The Alarm sound takes precedence over the Chime sound.
-
- 3. The event area. This allows you to select an Arexx program
- or Batch file to launch when the alarm time is reached. Just
- select the type of event you want, and then type in or load the
- batch or arexx program you want to run. The program will open a
- console window ONLY if the program runnning needs to produce some
- output.
-
- NB. TO TURN ON THE ALARM YOU MUST SELECT THE "ALARM ON" GADGET IN
- THE MAIN WINDOW.
-
- -----------------------------------------------------------------
- -Talk Options Window-
- -----------------------------------------------------------------
- Selecting the Talk Options button will bring up the Talk Options
- window.
-
- This panel allows you to select between:
-
- 1. Internal speech ie speech produced by the Amigas own Narrator
- device. When this option is selected you must tell the program
- where to find the Data file. The default place to find it is
- ENVARC:MultiClock/MultiClock.talkdata
-
- This file is simply a text file with numbers in the narrator
- devices phoneme format. This can be edited to make them sound
- better or different. The only thing is that they must be in the
- same order and they must be valid phonemes.
-
- A few of the Narrator device options can be selected from this
- panel, but not all. (Under WB 2.0 there are about 20 different
- options that can be changed!) You can change the sex of the voice
- with one cycle gadget and from a natural voice to a robotic voice
- with the other. This also gives you the option of a "manual"
- voice. This treats the emphasis on phonemes without regard to
- their surrounding phonemes and thus enables you to more easily get
- the effect you want by changing the emphasis on some syllables.
- The slider gadgets give you control over pitch and rate and the
- default settings button changes everything back to the system
- default values.
-
- 2. Sampled speech is produced by stringing together sound samples
- which are in standard IFF 8SVX format. There is no reason why you
- cannot use your own voice, the only requirement is that the sound
- samples must be named as the ones in the release are, for the
- program to find them properly, and they must be less than 102400
- bytes long!
-
- To use this option you must select the directory in which the
- sound samples reside. This defaults to ENVARC:MultiClock/Sounds
-
- The "Test Voice" button will say the current time using the
- current settings.
-
- Again, the OK button will set the current settings for use and the
- cancel button will go back to the previous settings.
-
- -----------------------------------------------------------------
- -Load/Save Config-
- -----------------------------------------------------------------
- The Load Config and Save Config buttons will load or save the
- entire configuration of the clock. The default directory for
- saving config files is ENVARC:MultiClock. If the program detects
- a file called MultiClock.config in this directory at startup it
- will automatically load and use this config file. At any time you
- can load another config file and these files can have any name.
-
- -----------------------------------------------------------------
- -Hide & Quit-
- -----------------------------------------------------------------
- The Hide button will close the Clock window but leave the clock
- itself running. The Quit button will close the clock down
- completely. These buttons have the keyboard equivalents 'H' and
- 'Q' respectively.
-
- -----------------------------------------------------------------
- -Thanks-
- -----------------------------------------------------------------
- Thanks to Simon Shead for his work in Beta testing this program
- and also to Rohan Safstrom and Gary Gajic.